Especificando uma Lista de Parâmetros para uma Macro

Para obter um tratamento mais detalhado desse tópico, consulte Transmitindo uma Lista de Parâmetros para uma Macro no Guia de Programação de Macros (principalmente para administradores de sistema e escritores de macros).

O Que é uma Lista de Parâmetros?

Algumas macros permitem a especificação de uma lista de parâmetros quando você reproduz a macro. A lista de parâmetros pode ser obrigatória ou opcional.

Uma lista de parâmetros é um conjunto de valores que informa à macro como desempenhar seu trabalho. Por exemplo, uma macro nomeada FileDownload poderia esperar a especificação de uma lista de parâmetros contendo os dois valores a seguir:

• Um nome de arquivo remoto (o nome do arquivo a ser feito download a partir de um host remoto), como por exemplo NewData.123 e
• Um nome de arquivo local (o nome a ser estabelecido para esse arquivo após o download), como por exemplo MyData.123.

Quais Parâmetros é Necessário Especificar?

A lista de parâmetros de cada macro é diferente. O administrador do sistema ou o autor da macro devem fornecer instruções e exemplos para especificação da lista de parâmetros.

Você pode verificar o campo Descrição da macro, para ver se ele contém uma descrição de uma lista de parâmetros. Para verificar o campo Descrição da macro, abra a janela Propriedades da Macro a partir de uma das seguintes janelas:

• A janela Macros Disponíveis (Propriedades)
• A janela Reproduzir Macro (Propriedades)

O Formato de uma Lista de Parâmetros

Esta seção descreve brevemente o formato de uma lista de parâmetros. Para obter detalhes adicionais, consulte Formato de uma Lista de Parâmetros no Guia de Programação de Macros (principalmente para administradores de sistema e escritores de macros).

O padrão de uma lista de parâmetros para uma macro é:

Formato de regras:

• Lista de Parâmetros

  Uma lista de parâmetros é uma série de pares nome-valor. Você pode especificar qualquer número de pares, contanto que cada par faça referência a uma variável real definida na macro. Utilize um espaço em branco, uma vírgula ou ambos para separar um par nome-valor do próximo. No exemplo anterior, há dois pares nome-valor:

  • strRemoteFile="NewData.123" é o primeiro par nome-valor.
  • strLocalFile="MyData.123" é o segundo par nome-valor.
  Também no exemplo anterior, uma vírgula e espaço (, ) depois do primeiro par nome-valor, o separa do segundo par nome-valor.

• Pares Nome-Valor

  Cada par nome-valor consiste em:

  • O nome de uma variável que já está definido na macro (como por exemplo strRemoteFile no primeiro par nome-valor no exemplo anterior); seguido por
  • Um sinal de igual (=); seguido por
  • Um valor inicial para a variável, colocado entre aspas ("NewData.123" no primeiro par nome-valor no exemplo anterior.)

• Nome da Variável

  Escreva o nome da variável exatamente como ele é escrito na macro, por exemplo strRemoteFile. A variável deve ser uma variável pertencente a um tipo de dados padrão (inteiro, duplo, cadeia ou booleano). Não é possível especificar uma variável pertencente a um tipo importado.

• Sinal de Igual (=)

  Um sinal de igual é obrigatório entre o nome e o valor da variável.

• Valor da Variável

  O valor da variável deve ser colocado entre aspas duplas (""), por exemplo "NewData.123". O valor deve ser um valor simples, não uma expressão.

  As regras para as variáveis de cadeia:

  • Não coloque a cadeia entre aspas simples. Errado: "'123 Elm Street'". Correto: "123 Elm Street".
  • Para especificar uma cadeia vazia, utilize duas aspas duplas sem nada entre elas ("" ).
  • Seqüências de escape:
    • Para especificar uma aspa simples (' ), utilize \'. Exemplo: "John\'s Business Plan"
    • Para especificar uma barra invertida (\ ), utilize \\. Exemplo: "c:\\Documents and Settings"

  Exemplo com um par nome-valor de cada tipo de dados padrão:
  
  intLineCount="24", dblLength="1441.25", strName="John Smith", boolComplete="true"

Tópicos Relacionados